apr

类 线程

系统.对象
    └apr.线程


公开 类 线程 <基类型 = 系统.对象

本类提供了操作线程的方法。使用方法:继承“线程”类并覆盖“执行()”方法,创建子类实例,调用“创建并启动”方法启动线程。 实现“执行接口”并重写“执行()”方法,将执行接口对象作为参数调用“创建并启动”方法启动线程。


方法摘要
公开 apr.返回码

创建并启动(apr.线程属性 线程属性对象, 系统.通用型[] 参数, apr.内存池 内存池对象, 逻辑 是否清理 = 假) 

    创建并启动线程。本方法将创建一个新的内存池(参数“内存池对象”为它的父内存池)给新启动的线程使用。

扩展 整数

执行(系统.通用型[] 通用型数组) 

    在继承类里覆盖本方法。

公开 apr.返回码

终止(整数 退出码) 

    立即终止当前线程,销毁线程使用的内存池。注意,如果在线程内调用本方法可能会导致GC报错,这需要在调用前手动减少变量(线程对象、执行接口对象、参数)的引用计数。

公开 静态 整数

合并(apr.线程 线程对象) 

    调用本方法的线程将一直阻塞,直到指定线程从启动例程中返回。本方法设置返回码,执行成功时返回指定线程退出码,失败返回-1。

公开 静态

出让执行权() 

    强迫当前线程挂起,出让CPU执行权。

公开 apr.返回码

分离() 

    分离线程。非分离的线程终止时,其线程ID和退出状态将保留,直到主线程调用“合并”方法才释放资源。分离的线程在终止时,所有资源将释放,不必合并该线程。

公开 文本

取数据(文本 键名) 

    取得键名对应的数据。本方法设置返回码,成功返回键值,失败返回空文本。

公开 apr.返回码

置数据(文本 键值, 文本 键名, apr.内存池 内存池对象) 

    置数据到线程所使用的内存池。

公开 apr.内存池

取内存池(apr.线程 线程对象) 

    取得线程关联的内存池,它在“创建并启动”时创建,在调用“终止”方法或进程终止时被销毁。本方法设置返回码,成功返回内存池对象,失败返回空对象。

公开 apr.返回码

创建并启动(apr.执行接口 执行接口对象, apr.线程属性 线程属性对象<可为空>, 系统.通用型[] 参数, apr.内存池 内存池对象, 逻辑 是否清理 = 假) 

    创建并启动线程。本方法将创建一个新的内存池(参数“内存池对象”为它的父内存池)给新启动的线程使用。

公开 静态 整数

取当前线程ID() 

系统.对象 继承的方法
比较类型, 是否实现, 取类名, 发送事件, 等于, 比较, 到文本, 比较引用

创建并启动

公开 apr.返回码 创建并启动(apr.线程属性 线程属性对象, 系统.通用型[] 参数, apr.内存池 内存池对象, 逻辑 是否清理 = 假)

    创建并启动线程。本方法将创建一个新的内存池(参数“内存池对象”为它的父内存池)给新启动的线程使用。

参数:

    线程属性对象

    参数 - 为“执行”方法提供的参数。

    内存池对象

    是否清理 - 是否在结束前调用“终止”方法进行清理(销毁线程内存池)并终止线程,“真”表示肯定。


执行

扩展 整数 执行(系统.通用型[] 通用型数组)

    在继承类里覆盖本方法。

参数:

    通用型数组


终止

公开 apr.返回码 终止(整数 退出码)

    立即终止当前线程,销毁线程使用的内存池。注意,如果在线程内调用本方法可能会导致GC报错,这需要在调用前手动减少变量(线程对象、执行接口对象、参数)的引用计数。

参数:

    退出码 - 线程的退出码。


合并

公开 静态 整数 合并(apr.线程 线程对象)

    调用本方法的线程将一直阻塞,直到指定线程从启动例程中返回。本方法设置返回码,执行成功时返回指定线程退出码,失败返回-1。

参数:

    线程对象 - 要合并的线程对象。


出让执行权

公开 静态 出让执行权()

    强迫当前线程挂起,出让CPU执行权。


分离

公开 apr.返回码 分离()

    分离线程。非分离的线程终止时,其线程ID和退出状态将保留,直到主线程调用“合并”方法才释放资源。分离的线程在终止时,所有资源将释放,不必合并该线程。


取数据

公开 文本 取数据(文本 键名)

    取得键名对应的数据。本方法设置返回码,成功返回键值,失败返回空文本。

参数:

    键名


置数据

公开 apr.返回码 置数据(文本 键值, 文本 键名, apr.内存池 内存池对象)

    置数据到线程所使用的内存池。

参数:

    键值

    键名

    内存池对象


取内存池

公开 apr.内存池 取内存池(apr.线程 线程对象)

    取得线程关联的内存池,它在“创建并启动”时创建,在调用“终止”方法或进程终止时被销毁。本方法设置返回码,成功返回内存池对象,失败返回空对象。

参数:

    线程对象


创建并启动

公开 apr.返回码 创建并启动(apr.执行接口 执行接口对象, apr.线程属性 线程属性对象<可为空>, 系统.通用型[] 参数, apr.内存池 内存池对象, 逻辑 是否清理 = 假)

    创建并启动线程。本方法将创建一个新的内存池(参数“内存池对象”为它的父内存池)给新启动的线程使用。

参数:

    执行接口对象

    线程属性对象

    参数 - 为“执行”方法提供的参数。

    内存池对象

    是否清理 - 是否在结束前调用“终止”方法进行清理(销毁线程内存池)并终止线程,“真”表示肯定。


取当前线程ID

公开 静态 整数 取当前线程ID()



http://dotef.eyuyan.com